Scale: Improve docs of format-value property

diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c
index 45e51c1691ae01f8223aca99454b119c8514d23a..d6f0eb5eef0937dd3f88f6504ae170bb5967e130 100644 (file)
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -735,6 +735,9 @@ gtk_scale_class_init (GtkScaleClass *class)
    * Connect a signal handler which returns an allocated string representing 
    * @value. That string will then be used to display the scale's value.
    *
+   * If no user-provided handlers are installed, the value will be displayed on
+   * its own, rounded according to the value of the #GtkScale:digits property.
+   *
    * Here's an example signal handler which displays a value 1.0 as
    * with "-->1.0<--".
    * |[<!-- language="C" -->
@@ -1901,8 +1904,7 @@ weed_out_neg_zero (gchar *str,
 }
 
 /*
- * Emits #GtkScale:format-value signal to format the value,
- * if no user signal handlers, falls back to a default format.
+ * Emits the #GtkScale:format-value signal.
  *
  * Returns: formatted value
  */